/ Celestin Apprentice 4 / Apprentice-Release4.iso / Source Code / C / Applications / Python 1.3 / source code / Doc / libtime.tex

< prev

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 73 65 63 74 69 6f 6e | 7b 42 75 69 6c 74 2d 69 |\section|{Built-i|
|00000010| 6e 20 4d 6f 64 75 6c 65 | 20 5c 73 65 63 74 63 6f |n Module| \sectco|
|00000020| 64 65 7b 74 69 6d 65 7d | 7d 0d 0d 5c 62 69 6d 6f |de{time}|}..\bimo|
|00000030| 64 69 6e 64 65 78 7b 74 | 69 6d 65 7d 0d 54 68 69 |dindex{t|ime}.Thi|
|00000040| 73 20 6d 6f 64 75 6c 65 | 20 70 72 6f 76 69 64 65 |s module| provide|
|00000050| 73 20 76 61 72 69 6f 75 | 73 20 74 69 6d 65 2d 72 |s variou|s time-r|
|00000060| 65 6c 61 74 65 64 20 66 | 75 6e 63 74 69 6f 6e 73 |elated f|unctions|
|00000070| 2e 0d 49 74 20 69 73 20 | 61 6c 77 61 79 73 20 61 |..It is |always a|
|00000080| 76 61 69 6c 61 62 6c 65 | 2e 0d 0d 41 6e 20 65 78 |vailable|...An ex|
|00000090| 70 6c 61 6e 61 74 69 6f | 6e 20 6f 66 20 73 6f 6d |planatio|n of som|
|000000a0| 65 20 74 65 72 6d 69 6e | 6f 6c 6f 67 79 20 61 6e |e termin|ology an|
|000000b0| 64 20 63 6f 6e 76 65 6e | 74 69 6f 6e 73 20 69 73 |d conven|tions is|
|000000c0| 20 69 6e 20 6f 72 64 65 | 72 2e 0d 0d 5c 62 65 67 | in orde|r...\beg|
|000000d0| 69 6e 7b 69 74 65 6d 69 | 7a 65 7d 0d 0d 5c 69 74 |in{itemi|ze}..\it|
|000000e0| 65 6d 0d 54 68 65 20 60 | 60 65 70 6f 63 68 27 27 |em.The `|`epoch''|
|000000f0| 20 69 73 20 74 68 65 20 | 70 6f 69 6e 74 20 77 68 | is the |point wh|
|00000100| 65 72 65 20 74 68 65 20 | 74 69 6d 65 20 73 74 61 |ere the |time sta|
|00000110| 72 74 73 2e 20 20 4f 6e | 20 4a 61 6e 75 61 72 79 |rts.  On| January|
|00000120| 20 31 73 74 20 6f 66 20 | 74 68 61 74 0d 79 65 61 | 1st of |that.yea|
|00000130| 72 2c 20 61 74 20 30 20 | 68 6f 75 72 73 2c 20 74 |r, at 0 |hours, t|
|00000140| 68 65 20 60 60 74 69 6d | 65 20 73 69 6e 63 65 20 |he ``tim|e since |
|00000150| 74 68 65 20 65 70 6f 63 | 68 27 27 20 69 73 20 7a |the epoc|h'' is z|
|00000160| 65 72 6f 2e 20 20 46 6f | 72 20 55 4e 49 58 2c 20 |ero.  Fo|r UNIX, |
|00000170| 74 68 65 0d 65 70 6f 63 | 68 20 69 73 20 31 39 37 |the.epoc|h is 197|
|00000180| 30 2e 20 20 54 6f 20 66 | 69 6e 64 20 6f 75 74 20 |0.  To f|ind out |
|00000190| 77 68 61 74 20 74 68 65 | 20 65 70 6f 63 68 20 69 |what the| epoch i|
|000001a0| 73 2c 20 6c 6f 6f 6b 20 | 61 74 20 5c 63 6f 64 65 |s, look |at \code|
|000001b0| 7b 67 6d 74 69 6d 65 28 | 30 29 7d 2e 0d 0d 5c 69 |{gmtime(|0)}...\i|
|000001c0| 74 65 6d 0d 55 54 43 20 | 69 73 20 43 6f 6f 72 64 |tem.UTC |is Coord|
|000001d0| 69 6e 61 74 65 64 20 55 | 6e 69 76 65 72 73 61 6c |inated U|niversal|
|000001e0| 20 54 69 6d 65 20 28 66 | 6f 72 6d 65 72 6c 79 20 | Time (f|ormerly |
|000001f0| 6b 6e 6f 77 6e 20 61 73 | 20 47 72 65 65 6e 77 69 |known as| Greenwi|
|00000200| 63 68 20 4d 65 61 6e 0d | 54 69 6d 65 29 2e 20 20 |ch Mean.|Time).  |
|00000210| 54 68 65 20 61 63 72 6f | 6e 79 6d 20 55 54 43 20 |The acro|nym UTC |
|00000220| 69 73 20 6e 6f 74 20 61 | 20 6d 69 73 74 61 6b 65 |is not a| mistake|
|00000230| 20 62 75 74 20 61 20 63 | 6f 6d 70 72 6f 6d 69 73 | but a c|ompromis|
|00000240| 65 20 62 65 74 77 65 65 | 6e 0d 45 6e 67 6c 69 73 |e betwee|n.Englis|
|00000250| 68 20 61 6e 64 20 46 72 | 65 6e 63 68 2e 0d 0d 5c |h and Fr|ench...\|
|00000260| 69 74 65 6d 0d 44 53 54 | 20 69 73 20 44 61 79 6c |item.DST| is Dayl|
|00000270| 69 67 68 74 20 53 61 76 | 69 6e 67 20 54 69 6d 65 |ight Sav|ing Time|
|00000280| 2c 20 61 6e 20 61 64 6a | 75 73 74 6d 65 6e 74 20 |, an adj|ustment |
|00000290| 6f 66 20 74 68 65 20 74 | 69 6d 65 7a 6f 6e 65 20 |of the t|imezone |
|000002a0| 62 79 0d 28 75 73 75 61 | 6c 6c 79 29 20 6f 6e 65 |by.(usua|lly) one|
|000002b0| 20 68 6f 75 72 20 64 75 | 72 69 6e 67 20 70 61 72 | hour du|ring par|
|000002c0| 74 20 6f 66 20 74 68 65 | 20 79 65 61 72 2e 20 20 |t of the| year.  |
|000002d0| 44 53 54 20 72 75 6c 65 | 73 20 61 72 65 20 6d 61 |DST rule|s are ma|
|000002e0| 67 69 63 0d 28 64 65 74 | 65 72 6d 69 6e 65 64 20 |gic.(det|ermined |
|000002f0| 62 79 20 6c 6f 63 61 6c | 20 6c 61 77 29 20 61 6e |by local| law) an|
|00000300| 64 20 63 61 6e 20 63 68 | 61 6e 67 65 20 66 72 6f |d can ch|ange fro|
|00000310| 6d 20 79 65 61 72 20 74 | 6f 20 79 65 61 72 2e 20 |m year t|o year. |
|00000320| 20 54 68 65 20 43 0d 6c | 69 62 72 61 72 79 20 68 | The C.l|ibrary h|
|00000330| 61 73 20 61 20 74 61 62 | 6c 65 20 63 6f 6e 74 61 |as a tab|le conta|
|00000340| 69 6e 69 6e 67 20 74 68 | 65 20 6c 6f 63 61 6c 20 |ining th|e local |
|00000350| 72 75 6c 65 73 20 28 6f | 66 74 65 6e 20 69 74 20 |rules (o|ften it |
|00000360| 69 73 20 72 65 61 64 20 | 66 72 6f 6d 0d 61 20 73 |is read |from.a s|
|00000370| 79 73 74 65 6d 20 66 69 | 6c 65 20 66 6f 72 20 66 |ystem fi|le for f|
|00000380| 6c 65 78 69 62 69 6c 69 | 74 79 29 20 61 6e 64 20 |lexibili|ty) and |
|00000390| 69 73 20 74 68 65 20 6f | 6e 6c 79 20 73 6f 75 72 |is the o|nly sour|
|000003a0| 63 65 20 6f 66 20 54 72 | 75 65 20 57 69 73 64 6f |ce of Tr|ue Wisdo|
|000003b0| 6d 0d 69 6e 20 74 68 69 | 73 20 72 65 73 70 65 63 |m.in thi|s respec|
|000003c0| 74 2e 0d 0d 5c 69 74 65 | 6d 0d 54 68 65 20 70 72 |t...\ite|m.The pr|
|000003d0| 65 63 69 73 69 6f 6e 20 | 6f 66 20 74 68 65 20 76 |ecision |of the v|
|000003e0| 61 72 69 6f 75 73 20 72 | 65 61 6c 2d 74 69 6d 65 |arious r|eal-time|
|000003f0| 20 66 75 6e 63 74 69 6f | 6e 73 20 6d 61 79 20 62 | functio|ns may b|
|00000400| 65 20 6c 65 73 73 20 74 | 68 61 6e 0d 73 75 67 67 |e less t|han.sugg|
|00000410| 65 73 74 65 64 20 62 79 | 20 74 68 65 20 75 6e 69 |ested by| the uni|
|00000420| 74 73 20 69 6e 20 77 68 | 69 63 68 20 74 68 65 69 |ts in wh|ich thei|
|00000430| 72 20 76 61 6c 75 65 20 | 6f 72 20 61 72 67 75 6d |r value |or argum|
|00000440| 65 6e 74 20 69 73 20 65 | 78 70 72 65 73 73 65 64 |ent is e|xpressed|
|00000450| 2e 0d 45 2e 67 2e 5c 20 | 6f 6e 20 6d 6f 73 74 20 |..E.g.\ |on most |
|00000460| 55 4e 49 58 20 73 79 73 | 74 65 6d 73 2c 20 74 68 |UNIX sys|tems, th|
|00000470| 65 20 63 6c 6f 63 6b 20 | 60 60 74 69 63 6b 73 27 |e clock |``ticks'|
|00000480| 27 20 6f 6e 6c 79 20 35 | 30 20 6f 72 20 31 30 30 |' only 5|0 or 100|
|00000490| 20 74 69 6d 65 73 20 61 | 0d 73 65 63 6f 6e 64 2c | times a|.second,|
|000004a0| 20 61 6e 64 20 6f 6e 20 | 74 68 65 20 4d 61 63 2c | and on |the Mac,|
|000004b0| 20 74 69 6d 65 73 20 61 | 72 65 20 6f 6e 6c 79 20 | times a|re only |
|000004c0| 61 63 63 75 72 61 74 65 | 20 74 6f 20 77 68 6f 6c |accurate| to whol|
|000004d0| 65 20 73 65 63 6f 6e 64 | 73 2e 0d 0d 5c 65 6e 64 |e second|s...\end|
|000004e0| 7b 69 74 65 6d 69 7a 65 | 7d 0d 0d 54 68 65 20 6d |{itemize|}..The m|
|000004f0| 6f 64 75 6c 65 20 64 65 | 66 69 6e 65 73 20 74 68 |odule de|fines th|
|00000500| 65 20 66 6f 6c 6c 6f 77 | 69 6e 67 20 66 75 6e 63 |e follow|ing func|
|00000510| 74 69 6f 6e 73 20 61 6e | 64 20 64 61 74 61 20 69 |tions an|d data i|
|00000520| 74 65 6d 73 3a 0d 0d 5c | 72 65 6e 65 77 63 6f 6d |tems:..\|renewcom|
|00000530| 6d 61 6e 64 7b 5c 69 6e | 64 65 78 73 75 62 69 74 |mand{\in|dexsubit|
|00000540| 65 6d 7d 7b 28 69 6e 20 | 6d 6f 64 75 6c 65 20 74 |em}{(in |module t|
|00000550| 69 6d 65 29 7d 0d 0d 5c | 62 65 67 69 6e 7b 64 61 |ime)}..\|begin{da|
|00000560| 74 61 64 65 73 63 7d 7b | 61 6c 74 7a 6f 6e 65 7d |tadesc}{|altzone}|
|00000570| 0d 54 68 65 20 6f 66 66 | 73 65 74 20 6f 66 20 74 |.The off|set of t|
|00000580| 68 65 20 6c 6f 63 61 6c | 20 44 53 54 20 74 69 6d |he local| DST tim|
|00000590| 65 7a 6f 6e 65 2c 20 69 | 6e 20 73 65 63 6f 6e 64 |ezone, i|n second|
|000005a0| 73 20 77 65 73 74 20 6f | 66 20 74 68 65 20 30 74 |s west o|f the 0t|
|000005b0| 68 0d 6d 65 72 69 64 69 | 61 6e 2c 20 69 66 20 6f |h.meridi|an, if o|
|000005c0| 6e 65 20 69 73 20 64 65 | 66 69 6e 65 64 2e 20 20 |ne is de|fined.  |
|000005d0| 4e 65 67 61 74 69 76 65 | 20 69 66 20 74 68 65 20 |Negative| if the |
|000005e0| 6c 6f 63 61 6c 20 44 53 | 54 20 74 69 6d 65 7a 6f |local DS|T timezo|
|000005f0| 6e 65 20 69 73 0d 65 61 | 73 74 20 6f 66 20 74 68 |ne is.ea|st of th|
|00000600| 65 20 30 74 68 20 6d 65 | 72 69 64 69 61 6e 20 28 |e 0th me|ridian (|
|00000610| 61 73 20 69 6e 20 57 65 | 73 74 65 72 6e 20 45 75 |as in We|stern Eu|
|00000620| 72 6f 70 65 2c 20 69 6e | 63 6c 75 64 69 6e 67 20 |rope, in|cluding |
|00000630| 74 68 65 20 55 4b 29 2e | 0d 4f 6e 6c 79 20 75 73 |the UK).|.Only us|
|00000640| 65 20 74 68 69 73 20 69 | 66 20 5c 63 6f 64 65 7b |e this i|f \code{|
|00000650| 64 61 79 6c 69 67 68 74 | 7d 20 69 73 20 6e 6f 6e |daylight|} is non|
|00000660| 7a 65 72 6f 2e 0d 5c 65 | 6e 64 7b 64 61 74 61 64 |zero..\e|nd{datad|
|00000670| 65 73 63 7d 0d 0d 0d 5c | 62 65 67 69 6e 7b 66 75 |esc}...\|begin{fu|
|00000680| 6e 63 64 65 73 63 7d 7b | 61 73 63 74 69 6d 65 7d |ncdesc}{|asctime}|
|00000690| 7b 74 75 70 6c 65 7d 0d | 43 6f 6e 76 65 72 74 20 |{tuple}.|Convert |
|000006a0| 61 20 74 75 70 6c 65 20 | 72 65 70 72 65 73 65 6e |a tuple |represen|
|000006b0| 74 69 6e 67 20 61 20 74 | 69 6d 65 20 61 73 20 72 |ting a t|ime as r|
|000006c0| 65 74 75 72 6e 65 64 20 | 62 79 20 5c 63 6f 64 65 |eturned |by \code|
|000006d0| 7b 67 6d 74 69 6d 65 28 | 29 7d 20 6f 72 0d 5c 63 |{gmtime(|)} or.\c|
|000006e0| 6f 64 65 7b 6c 6f 63 61 | 6c 74 69 6d 65 28 29 7d |ode{loca|ltime()}|
|000006f0| 20 74 6f 20 61 20 32 34 | 2d 63 68 61 72 61 63 74 | to a 24|-charact|
|00000700| 65 72 20 73 74 72 69 6e | 67 20 6f 66 20 74 68 65 |er strin|g of the|
|00000710| 20 66 6f 6c 6c 6f 77 69 | 6e 67 20 66 6f 72 6d 3a | followi|ng form:|
|00000720| 0d 5c 63 6f 64 65 7b 27 | 53 75 6e 20 4a 75 6e 20 |.\code{'|Sun Jun |
|00000730| 32 30 20 32 33 3a 32 31 | 3a 30 35 20 31 39 39 33 |20 23:21|:05 1993|
|00000740| 27 7d 2e 20 20 4e 6f 74 | 65 3a 20 75 6e 6c 69 6b |'}.  Not|e: unlik|
|00000750| 65 20 74 68 65 20 43 20 | 66 75 6e 63 74 69 6f 6e |e the C |function|
|00000760| 20 6f 66 0d 74 68 65 20 | 73 61 6d 65 20 6e 61 6d | of.the |same nam|
|00000770| 65 2c 20 74 68 65 72 65 | 20 69 73 20 6e 6f 20 74 |e, there| is no t|
|00000780| 72 61 69 6c 69 6e 67 20 | 6e 65 77 6c 69 6e 65 2e |railing |newline.|
|00000790| 0d 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0d |.\end{fu|ncdesc}.|
|000007a0| 0d 0d 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|000007b0| 63 7d 7b 63 6c 6f 63 6b | 7d 7b 7d 0d 52 65 74 75 |c}{clock|}{}.Retu|
|000007c0| 72 6e 20 74 68 65 20 63 | 75 72 72 65 6e 74 20 43 |rn the c|urrent C|
|000007d0| 50 55 20 74 69 6d 65 20 | 61 73 20 61 20 66 6c 6f |PU time |as a flo|
|000007e0| 61 74 69 6e 67 20 70 6f | 69 6e 74 20 6e 75 6d 62 |ating po|int numb|
|000007f0| 65 72 20 65 78 70 72 65 | 73 73 65 64 20 69 6e 0d |er expre|ssed in.|
|00000800| 73 65 63 6f 6e 64 73 2e | 20 20 54 68 65 20 70 72 |seconds.|  The pr|
|00000810| 65 63 69 73 69 6f 6e 2c | 20 61 6e 64 20 69 6e 20 |ecision,| and in |
|00000820| 66 61 63 74 20 74 68 65 | 20 76 65 72 79 20 64 65 |fact the| very de|
|00000830| 66 69 6e 69 74 6f 6e 20 | 6f 66 20 74 68 65 20 6d |finiton |of the m|
|00000840| 65 61 6e 69 6e 67 0d 6f | 66 20 60 60 43 50 55 20 |eaning.o|f ``CPU |
|00000850| 74 69 6d 65 27 27 2c 20 | 64 65 70 65 6e 64 73 20 |time'', |depends |
|00000860| 6f 6e 20 74 68 61 74 20 | 6f 66 20 74 68 65 20 43 |on that |of the C|
|00000870| 20 66 75 6e 63 74 69 6f | 6e 20 6f 66 20 74 68 65 | functio|n of the|
|00000880| 20 73 61 6d 65 20 6e 61 | 6d 65 2e 0d 5c 65 6e 64 | same na|me..\end|
|00000890| 7b 66 75 6e 63 64 65 73 | 63 7d 0d 0d 0d 5c 62 65 |{funcdes|c}...\be|
|000008a0| 67 69 6e 7b 66 75 6e 63 | 64 65 73 63 7d 7b 63 74 |gin{func|desc}{ct|
|000008b0| 69 6d 65 7d 7b 73 65 63 | 73 7d 0d 43 6f 6e 76 65 |ime}{sec|s}.Conve|
|000008c0| 72 74 20 61 20 74 69 6d | 65 20 65 78 70 72 65 73 |rt a tim|e expres|
|000008d0| 73 65 64 20 69 6e 20 73 | 65 63 6f 6e 64 73 20 73 |sed in s|econds s|
|000008e0| 69 6e 63 65 20 74 68 65 | 20 65 70 6f 63 68 20 74 |ince the| epoch t|
|000008f0| 6f 20 61 20 73 74 72 69 | 6e 67 0d 72 65 70 72 65 |o a stri|ng.repre|
|00000900| 73 65 6e 74 69 6e 67 20 | 6c 6f 63 61 6c 20 74 69 |senting |local ti|
|00000910| 6d 65 2e 20 20 5c 63 6f | 64 65 7b 63 74 69 6d 65 |me.  \co|de{ctime|
|00000920| 28 74 29 7d 20 69 73 20 | 65 71 75 69 76 61 6c 65 |(t)} is |equivale|
|00000930| 6e 74 20 74 6f 0d 5c 63 | 6f 64 65 7b 61 73 63 74 |nt to.\c|ode{asct|
|00000940| 69 6d 65 28 6c 6f 63 61 | 6c 74 69 6d 65 28 74 29 |ime(loca|ltime(t)|
|00000950| 29 7d 2e 0d 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |)}..\end|{funcdes|
|00000960| 63 7d 0d 0d 5c 62 65 67 | 69 6e 7b 64 61 74 61 64 |c}..\beg|in{datad|
|00000970| 65 73 63 7d 7b 64 61 79 | 6c 69 67 68 74 7d 0d 4e |esc}{day|light}.N|
|00000980| 6f 6e 7a 65 72 6f 20 69 | 66 20 61 20 44 53 54 20 |onzero i|f a DST |
|00000990| 74 69 6d 65 7a 6f 6e 65 | 20 69 73 20 64 65 66 69 |timezone| is defi|
|000009a0| 6e 65 64 2e 0d 5c 65 6e | 64 7b 64 61 74 61 64 65 |ned..\en|d{datade|
|000009b0| 73 63 7d 0d 0d 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|000009c0| 64 65 73 63 7d 7b 67 6d | 74 69 6d 65 7d 7b 73 65 |desc}{gm|time}{se|
|000009d0| 63 73 7d 0d 43 6f 6e 76 | 65 72 74 20 61 20 74 69 |cs}.Conv|ert a ti|
|000009e0| 6d 65 20 65 78 70 72 65 | 73 73 65 64 20 69 6e 20 |me expre|ssed in |
|000009f0| 73 65 63 6f 6e 64 73 20 | 73 69 6e 63 65 20 74 68 |seconds |since th|
|00000a00| 65 20 65 70 6f 63 68 20 | 74 6f 20 61 20 74 75 70 |e epoch |to a tup|
|00000a10| 6c 65 20 6f 66 20 39 0d | 69 6e 74 65 67 65 72 73 |le of 9.|integers|
|00000a20| 2c 20 69 6e 20 55 54 43 | 3a 20 79 65 61 72 20 28 |, in UTC|: year (|
|00000a30| 65 2e 67 2e 5c 20 31 39 | 39 33 29 2c 20 6d 6f 6e |e.g.\ 19|93), mon|
|00000a40| 74 68 20 28 31 2d 2d 31 | 32 29 2c 20 64 61 79 20 |th (1--1|2), day |
|00000a50| 28 31 2d 2d 33 31 29 2c | 20 68 6f 75 72 0d 28 30 |(1--31),| hour.(0|
|00000a60| 2d 2d 32 33 29 2c 20 6d | 69 6e 75 74 65 20 28 30 |--23), m|inute (0|
|00000a70| 2d 2d 35 39 29 2c 20 73 | 65 63 6f 6e 64 20 28 30 |--59), s|econd (0|
|00000a80| 2d 2d 35 39 29 2c 20 77 | 65 65 6b 64 61 79 20 28 |--59), w|eekday (|
|00000a90| 30 2d 2d 36 2c 20 6d 6f | 6e 64 61 79 20 69 73 20 |0--6, mo|nday is |
|00000aa0| 30 29 2c 0d 4a 75 6c 69 | 61 6e 20 64 61 79 20 28 |0),.Juli|an day (|
|00000ab0| 31 2d 2d 33 36 36 29 2c | 20 64 73 74 20 66 6c 61 |1--366),| dst fla|
|00000ac0| 67 20 28 61 6c 77 61 79 | 73 20 7a 65 72 6f 29 2e |g (alway|s zero).|
|00000ad0| 20 20 46 72 61 63 74 69 | 6f 6e 73 20 6f 66 20 61 |  Fracti|ons of a|
|00000ae0| 20 73 65 63 6f 6e 64 20 | 61 72 65 0d 69 67 6e 6f | second |are.igno|
|00000af0| 72 65 64 2e 20 20 4e 6f | 74 65 20 73 75 62 74 6c |red.  No|te subtl|
|00000b00| 65 20 64 69 66 66 65 72 | 65 6e 63 65 73 20 77 69 |e differ|ences wi|
|00000b10| 74 68 20 74 68 65 20 43 | 20 66 75 6e 63 74 69 6f |th the C| functio|
|00000b20| 6e 20 6f 66 20 74 68 69 | 73 20 6e 61 6d 65 2e 0d |n of thi|s name..|
|00000b30| 5c 65 6e 64 7b 66 75 6e | 63 64 65 73 63 7d 0d 0d |\end{fun|cdesc}..|
|00000b40| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|00000b50| 7b 6c 6f 63 61 6c 74 69 | 6d 65 7d 7b 73 65 63 73 |{localti|me}{secs|
|00000b60| 7d 0d 4c 69 6b 65 20 5c | 63 6f 64 65 7b 67 6d 74 |}.Like \|code{gmt|
|00000b70| 69 6d 65 7d 20 62 75 74 | 20 63 6f 6e 76 65 72 74 |ime} but| convert|
|00000b80| 73 20 74 6f 20 6c 6f 63 | 61 6c 20 74 69 6d 65 2e |s to loc|al time.|
|00000b90| 20 20 54 68 65 20 64 73 | 74 20 66 6c 61 67 20 69 |  The ds|t flag i|
|00000ba0| 73 20 73 65 74 0d 74 6f | 20 31 20 77 68 65 6e 20 |s set.to| 1 when |
|00000bb0| 44 53 54 20 61 70 70 6c | 69 65 73 20 74 6f 20 74 |DST appl|ies to t|
|00000bc0| 68 65 20 67 69 76 65 6e | 20 74 69 6d 65 2e 0d 5c |he given| time..\|
|00000bd0| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0d 0d 5c |end{func|desc}..\|
|00000be0| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|00000bf0| 6d 6b 74 69 6d 65 7d 7b | 74 75 70 6c 65 7d 0d 54 |mktime}{|tuple}.T|
|00000c00| 68 69 73 20 69 73 20 74 | 68 65 20 69 6e 76 65 72 |his is t|he inver|
|00000c10| 73 65 20 66 75 6e 63 74 | 69 6f 6e 20 6f 66 20 5c |se funct|ion of \|
|00000c20| 63 6f 64 65 7b 6c 6f 63 | 61 6c 74 69 6d 65 7d 2e |code{loc|altime}.|
|00000c30| 20 20 49 74 73 20 61 72 | 67 75 6d 65 6e 74 20 69 |  Its ar|gument i|
|00000c40| 73 20 74 68 65 0d 66 75 | 6c 6c 20 39 2d 74 75 70 |s the.fu|ll 9-tup|
|00000c50| 6c 65 20 28 73 69 6e 63 | 65 20 74 68 65 20 64 73 |le (sinc|e the ds|
|00000c60| 74 20 66 6c 61 67 20 69 | 73 20 6e 65 65 64 65 64 |t flag i|s needed|
|00000c70| 29 2e 20 20 49 74 20 72 | 65 74 75 72 6e 73 20 61 |).  It r|eturns a|
|00000c80| 6e 20 69 6e 74 65 67 65 | 72 2e 0d 5c 65 6e 64 7b |n intege|r..\end{|
|00000c90| 66 75 6e 63 64 65 73 63 | 7d 0d 0d 5c 62 65 67 69 |funcdesc|}..\begi|
|00000ca0| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 73 6c 65 65 |n{funcde|sc}{slee|
|00000cb0| 70 7d 7b 73 65 63 73 7d | 0d 53 75 73 70 65 6e 64 |p}{secs}|.Suspend|
|00000cc0| 20 65 78 65 63 75 74 69 | 6f 6e 20 66 6f 72 20 74 | executi|on for t|
|00000cd0| 68 65 20 67 69 76 65 6e | 20 6e 75 6d 62 65 72 20 |he given| number |
|00000ce0| 6f 66 20 73 65 63 6f 6e | 64 73 2e 20 20 54 68 65 |of secon|ds.  The|
|00000cf0| 20 61 72 67 75 6d 65 6e | 74 20 6d 61 79 0d 62 65 | argumen|t may.be|
|00000d00| 20 61 20 66 6c 6f 61 74 | 69 6e 67 20 70 6f 69 6e | a float|ing poin|
|00000d10| 74 20 6e 75 6d 62 65 72 | 20 74 6f 20 69 6e 64 69 |t number| to indi|
|00000d20| 63 61 74 65 20 61 20 6d | 6f 72 65 20 70 72 65 63 |cate a m|ore prec|
|00000d30| 69 73 65 20 73 6c 65 65 | 70 20 74 69 6d 65 2e 0d |ise slee|p time..|
|00000d40| 5c 65 6e 64 7b 66 75 6e | 63 64 65 73 63 7d 0d 0d |\end{fun|cdesc}..|
|00000d50| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|00000d60| 7b 73 74 72 66 74 69 6d | 65 7d 7b 66 6f 72 6d 61 |{strftim|e}{forma|
|00000d70| 74 2c 20 74 75 70 6c 65 | 7d 0d 43 6f 6e 76 65 72 |t, tuple|}.Conver|
|00000d80| 74 20 61 20 74 75 70 6c | 65 20 72 65 70 72 65 73 |t a tupl|e repres|
|00000d90| 65 6e 74 69 6e 67 20 61 | 20 74 69 6d 65 20 61 73 |enting a| time as|
|00000da0| 20 72 65 74 75 72 6e 65 | 64 20 62 79 20 5c 63 6f | returne|d by \co|
|00000db0| 64 65 7b 67 6d 74 69 6d | 65 28 29 7d 20 6f 72 0d |de{gmtim|e()} or.|
|00000dc0| 5c 63 6f 64 65 7b 6c 6f | 63 61 6c 74 69 6d 65 28 |\code{lo|caltime(|
|00000dd0| 29 7d 20 74 6f 20 61 20 | 73 74 72 69 6e 67 20 61 |)} to a |string a|
|00000de0| 73 20 73 70 65 63 69 66 | 69 65 64 20 62 79 20 74 |s specif|ied by t|
|00000df0| 68 65 20 66 6f 72 6d 61 | 74 20 61 72 67 75 6d 65 |he forma|t argume|
|00000e00| 6e 74 2e 0d 53 65 65 20 | 74 68 65 20 5c 63 6f 64 |nt..See |the \cod|
|00000e10| 65 7b 73 74 72 66 74 69 | 6d 65 28 33 29 7d 20 6d |e{strfti|me(3)} m|
|00000e20| 61 6e 20 70 61 67 65 20 | 66 6f 72 20 64 65 74 61 |an page |for deta|
|00000e30| 69 6c 73 20 6f 66 20 74 | 68 65 20 73 79 6e 74 61 |ils of t|he synta|
|00000e40| 78 20 6f 66 0d 66 6f 72 | 6d 61 74 20 73 74 72 69 |x of.for|mat stri|
|00000e50| 6e 67 73 2e 0d 5c 65 6e | 64 7b 66 75 6e 63 64 65 |ngs..\en|d{funcde|
|00000e60| 73 63 7d 0d 0d 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|00000e70| 64 65 73 63 7d 7b 74 69 | 6d 65 7d 7b 7d 0d 52 65 |desc}{ti|me}{}.Re|
|00000e80| 74 75 72 6e 20 74 68 65 | 20 74 69 6d 65 20 61 73 |turn the| time as|
|00000e90| 20 61 20 66 6c 6f 61 74 | 69 6e 67 20 70 6f 69 6e | a float|ing poin|
|00000ea0| 74 20 6e 75 6d 62 65 72 | 20 65 78 70 72 65 73 73 |t number| express|
|00000eb0| 65 64 20 69 6e 20 73 65 | 63 6f 6e 64 73 20 73 69 |ed in se|conds si|
|00000ec0| 6e 63 65 0d 74 68 65 20 | 65 70 6f 63 68 2c 20 69 |nce.the |epoch, i|
|00000ed0| 6e 20 55 54 43 2e 20 20 | 4e 6f 74 65 20 74 68 61 |n UTC.  |Note tha|
|00000ee0| 74 20 65 76 65 6e 20 74 | 68 6f 75 67 68 20 74 68 |t even t|hough th|
|00000ef0| 65 20 74 69 6d 65 20 69 | 73 20 61 6c 77 61 79 73 |e time i|s always|
|00000f00| 20 72 65 74 75 72 6e 65 | 64 0d 61 73 20 61 20 66 | returne|d.as a f|
|00000f10| 6c 6f 61 74 69 6e 67 20 | 70 6f 69 6e 74 20 6e 75 |loating |point nu|
|00000f20| 6d 62 65 72 2c 20 6e 6f | 74 20 61 6c 6c 20 73 79 |mber, no|t all sy|
|00000f30| 73 74 65 6d 73 20 70 72 | 6f 76 69 64 65 20 74 69 |stems pr|ovide ti|
|00000f40| 6d 65 20 77 69 74 68 20 | 61 20 62 65 74 74 65 72 |me with |a better|
|00000f50| 0d 70 72 65 63 69 73 69 | 6f 6e 20 74 68 61 6e 20 |.precisi|on than |
|00000f60| 31 20 73 65 63 6f 6e 64 | 2e 0d 5c 65 6e 64 7b 66 |1 second|..\end{f|
|00000f70| 75 6e 63 64 65 73 63 7d | 0d 0d 5c 62 65 67 69 6e |uncdesc}|..\begin|
|00000f80| 7b 64 61 74 61 64 65 73 | 63 7d 7b 74 69 6d 65 7a |{datades|c}{timez|
|00000f90| 6f 6e 65 7d 0d 54 68 65 | 20 6f 66 66 73 65 74 20 |one}.The| offset |
|00000fa0| 6f 66 20 74 68 65 20 6c | 6f 63 61 6c 20 28 6e 6f |of the l|ocal (no|
|00000fb0| 6e 2d 44 53 54 29 20 74 | 69 6d 65 7a 6f 6e 65 2c |n-DST) t|imezone,|
|00000fc0| 20 69 6e 20 73 65 63 6f | 6e 64 73 20 77 65 73 74 | in seco|nds west|
|00000fd0| 20 6f 66 20 74 68 65 20 | 30 74 68 0d 6d 65 72 69 | of the |0th.meri|
|00000fe0| 64 69 61 6e 20 28 69 2e | 65 2e 20 6e 65 67 61 74 |dian (i.|e. negat|
|00000ff0| 69 76 65 20 69 6e 20 6d | 6f 73 74 20 6f 66 20 57 |ive in m|ost of W|
|00001000| 65 73 74 65 72 6e 20 45 | 75 72 6f 70 65 2c 20 70 |estern E|urope, p|
|00001010| 6f 73 69 74 69 76 65 20 | 69 6e 20 74 68 65 20 55 |ositive |in the U|
|00001020| 53 2c 0d 7a 65 72 6f 20 | 69 6e 20 74 68 65 20 55 |S,.zero |in the U|
|00001030| 4b 29 2e 0d 5c 65 6e 64 | 7b 64 61 74 61 64 65 73 |K)..\end|{datades|
|00001040| 63 7d 0d 0d 5c 62 65 67 | 69 6e 7b 64 61 74 61 64 |c}..\beg|in{datad|
|00001050| 65 73 63 7d 7b 74 7a 6e | 61 6d 65 7d 0d 41 20 74 |esc}{tzn|ame}.A t|
|00001060| 75 70 6c 65 20 6f 66 20 | 74 77 6f 20 73 74 72 69 |uple of |two stri|
|00001070| 6e 67 73 3a 20 74 68 65 | 20 66 69 72 73 74 20 69 |ngs: the| first i|
|00001080| 73 20 74 68 65 20 6e 61 | 6d 65 20 6f 66 20 74 68 |s the na|me of th|
|00001090| 65 20 6c 6f 63 61 6c 20 | 6e 6f 6e 2d 44 53 54 0d |e local |non-DST.|
|000010a0| 74 69 6d 65 7a 6f 6e 65 | 2c 20 74 68 65 20 73 65 |timezone|, the se|
|000010b0| 63 6f 6e 64 20 69 73 20 | 74 68 65 20 6e 61 6d 65 |cond is |the name|
|000010c0| 20 6f 66 20 74 68 65 20 | 6c 6f 63 61 6c 20 44 53 | of the |local DS|
|000010d0| 54 20 74 69 6d 65 7a 6f | 6e 65 2e 20 20 49 66 20 |T timezo|ne.  If |
|000010e0| 6e 6f 20 44 53 54 0d 74 | 69 6d 65 7a 6f 6e 65 20 |no DST.t|imezone |
|000010f0| 69 73 20 64 65 66 69 6e | 65 64 2c 20 74 68 65 20 |is defin|ed, the |
|00001100| 73 65 63 6f 6e 64 20 73 | 74 72 69 6e 67 20 73 68 |second s|tring sh|
|00001110| 6f 75 6c 64 20 6e 6f 74 | 20 62 65 20 75 73 65 64 |ould not| be used|
|00001120| 2e 0d 5c 65 6e 64 7b 64 | 61 74 61 64 65 73 63 7d |..\end{d|atadesc}|
|00001130| 0d                      |                         |.       |        |
+--------+-------------------------+-------------------------+--------+--------+